Terrabrowser 1.0 by Chimoosoft
  ¨ for MacOS X

About:
Terrabrowser is a front end to Microsoft's Terra Server <http://terraserver.microsoft.com/> which contains satellite imagery and topo maps from the US Geological Survey (USGS, <http://www.usgs.gov/>).  The aim of this program is to provide a simpler and more user friendly interface to the data.  It doesn't support all of the features of the Terra Server such as search by name/region, but it does allow direct entry of latitude/longitude.

The Terra Server only covers the United States of America, so if you enter a location outside of the United States, the map will be blank.  Some regions don't contain satellite maps - Hawaii for one seems to only have topo maps available.  

Also note that the program downloads tiles from the Terra Server.  This means that the latitude/longitude you enter will not usually be in the center of the screen.  The red dot indicates the actual location.  You can also move the mouse and watch the mouse position display until it lines up with your location.

Terrabrowser is freeware - please use it and distribute it.  We do ask that you include this original readme file and that you don't modify or sell the program.  It may be included on archive CD's by magazines or Macintosh User Groups.  Please send us an email to let us know how you're using Terrabrowser!  <chimoosoft@yahoo.com>

Note, this software has been extensively tested, but is not guaranteed to be bug free.  Use at your own risk.

Donations:
Developing software takes time and energy!  If you like this product and would like to support future development of it and other projects, please consider donating.  The suggested donation is $5, however any amount will be greatly appreciated!

¨

There are several ways to donate:
	- Click on the PayPal button in the about box for Terrabrowser.
	- Go to <https://www.paypal.com/xclick/business=chimoosoft%40yahoo.com>
	- Visit our website at http://www.chimoosoft.com/ and click on the PayPal button.

Instructions:

You must have an internet connection to use this program - DSL/Cable or faster is recommended although not required. 

To view a particular location, enter the latitude and longitude in the appropriate fields.  You can switch between Degrees/Minutes/Seconds and decimal degrees (the default).  Then press the Fetch Image button or the return key.  The red marker dot is displayed at the position you entered - this will not usually be in the center since the image is downloaded in predefined tiles from the server.
	¨ (note red marker dot)

Use the navigation buttons to move in any compass direction.  Use the zoom slider to change the resolution of your photo, and use the popup menu below the zoom slider to select satellite photo or topo map.  

The Num Tiles popup menu selects how many tiles to display (4, 6, or 9). 

The latitude/longitude of your mouse cursor on the map is displayed below the Fetch Image button.  To turn this feature off (to reduce CPU usage) select that option from the Preferences.  

Terrabrowser comes with several built in bookmarks.  These are accessible from the Bookmarks menu.  You may also add your own bookmarks by either right clicking (control clicking) on a particular location, or using the Add Boomark option from the Bookmarks menu.  Note, when you add a bookmark from the menu, it will be added at a position relative to the position displayed in the position fields.  For example, if you enter a location, and then move to the East, the bookmark will be added one tile to the East of the original location.  If you use the contextual menu to add the bookmark, it will be added exactly at the point where you clicked the mouse.  Your bookmarks will be saved automatically when you quit Terrabrowser.

To manage your bookmarks, choose Manage Bookmarks from the Bookmarks menu.  The bookmark management interface allows you to edit the name/lat/lon of any bookmark by double clicking in the desired cell.  You can also drag a row to reorder it, add a new bookmark (press the + button), or delete multiple bookmarks at a time (select a few and press the - button).

You can save the current image by choosing Save... from the File menu.  

Known Issues:
	- The United States is divided up into vertical UTM Zones.  Scrolling from one UTMZone to another will result in a blank map because the zone is not updated.  To get around this problem, re-enter the current latitude and longitude and the program will update the zone correctly.  This problem will be fixed in the next version.
	- The image may appear corrupted if you try to move the map before it has finished downloading.
	- Spinning beach ball will occur sometimes if you don't wait for the map to finish.  It should go away after a little while.  If it doesn't, simply force the program to quit. 
	- Due to the way images are downloaded from the Terra Server, the latitude/longitude you enter will not usually be in the center of the screen.  The red position marker tells you where the actual location is.  You can also move the mouse and watch the cursor location display until it lines up with your location.  
	- DMS popup menus don't display N/S correctly when first switching to them.  This is a cosmetic bug only and doesn't affect performance.

Plans for Future Versions:
	- Printing support.
	- Drag and drop support for saving images.
	- OS X style toolbar.
	- Image cache to improve speed.
	- Display of city/region name.
	- Search by city/region name.
	- Ability to calculate distances between points.
	- Improved bookmark support
		- Display all bookmarks (waypoints) at once.
		- User settable icons for bookmarks/waypoints.
		- Export of the bookmarks file to other formats.
	- Allow import of waypoints/tracklogs from GPS receivers via serial-USB converter cable.

Version Change History:

1.0.4 30 May, 2003
	- Fixed a couple of bugs related to coordinate entry.

1.0.3 27 May, 2003
	- Microsoft changed their web address to <http://terraserver-usa.com/> which broke Terrabrowser.  Note, Microsoft has stated that the Terra Server will be slow for up to a week while they move their servers to a new location.  See this page for details: <http://terraserver-usa.com/About.aspx?n=AboutMoving>.
	- Changed Dec/DMS to a tab interface - UTM coordinates coming soon.

1.0.2 29 April, 2003
	- Fixed a couple of other bookmark management related bugs.

1.0.1 29 April, 2003
	- Fixed a bug when deleting all bookmarks at once.

1.0  28 April, 2003
	- First public release.

Credits:
Thanks to:

	- Beta testers (you know who you are!).

	- The USGS <http://www.usgs.gov/> and the Microsoft Terra Server <http://terraserver.microsoft.com/> for providing the images!

http://www.chimoosoft.com/
chimoosoft@yahoo.com